home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 4 / MacMania 4.toast / / Demo's / Igor Demo Pro / 1 PutContentsIn Igor Pro Folder / More Extensions / File Loaders / GWLoadWave Documentation < prev    next >
Text File  |  1993-01-22  |  3KB  |  72 lines
  1. *** GWLoadWave 1/23/93 ***
  2.  
  3. GWLoadWave is an Igor external operation (XOP) that loads data from GW
  4. Instruments files into Igor waves. To use GWLoadWave, you must drag the
  5. GWLoadWave file into the folder containing the Igor application before
  6. launching Igor.
  7.  
  8. GWLoadWave adds a 'Load GW File' item to the 'Load Waves' submenu
  9. of Igor's 'File' menu. It behaves much like Igor's built in LoadWave operation 
  10. except that it loads the GW Instruments file formats. It works with almost
  11. all wave files created by GW Instruments products. See below for file
  12. format details.
  13.  
  14. In addition to loading the data from these files, GWLoadWave sets the X scaling
  15. of the waves it creates if that information is available in the particular file
  16. format. 
  17.  
  18. You can access GWLoadWave through its menu item or by invoking the 
  19. GWLoadWave operation from the command line or from a macro. The 
  20. GWLoadWave operation has the following syntax:
  21.  
  22. GWLoadWave [[/P=path]/O/D/I/Q/A[=basename]] "filename"
  23.  
  24.     /P=path specifies a path where file can be found.
  25.     /O causes new waves to overwrite existing waves of the same name.
  26.     /D causes the new waves to be double precision.
  27.     /I causes GWLoadWave to put up the standard open dialog.
  28.     /Q suppresses normal diagnostic messages during load.
  29.     /A automatically names new waves using default names.
  30.     /A=basename specifies base name to use in generating the wave names.
  31.     /N like /A except it reuses existing names.
  32.     /N=basename like /A except it reuses existing names.
  33.  
  34. If neither /A nor /N is used then wave names are generated from
  35. the the file name.
  36.  
  37.     "filename" is a full file name for the file to load
  38.     or a partial file name if /P is used.
  39.     If "filename" is omitted GWLoadWave puts up the standard open dialog.
  40.  
  41.  
  42. *** File Format Details
  43.  
  44. 32 bit floating point MacAdios Manager STANDARD (type -2)
  45. 16 bit integer MacAdios Manager STANDARD (type -1)
  46. 16 bit integer Mac Speech Lab format (type 0 -- see note at bottom)
  47. 16 bit integer MacAdios Manager (type 1, save special, BASIC)
  48. 16 bit integer MacInstruments Binary (type 2)
  49. 32 bit floating point MacAdios Manager (type 3, save special, BASIC)
  50. 32 bit integer (type 4)
  51.  
  52. Type codes 0 through 4 are defined in the MacAdios Software Series Instruction
  53. Manual from GW Instruments. Type codes -1 and -2 are used by GWLoadWave
  54. to distinguish the STANDARD formats from the others.
  55.  
  56. NOTE:
  57. We can't guarantee that GWLoadWave will work with every GW file,
  58. past, present or future.
  59.  
  60. *** Note on Mac Speech Lab Format
  61.  
  62. The Mac Speech Lab files are structured as described for type code 0 in
  63. the GW manual. That is, they have a 16 bit sample rate number at the beginning.
  64. GWLoadWave will use this to set the X scaling for the waves it creates.
  65. However, the type code in Mac Speech Lab files is actually set to one.
  66. This causes GWLoadWave to load the file such that the sample rate information
  67. described in the GW manual is loaded as point zero of the wave.
  68. You can correct this using a file fudging program to set the file's data type
  69. code (bytes 0 and 1) to 0.
  70.  
  71.  
  72.